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1. PURPOSE 

This document defines the requirements necessary for the merge of 
program modules BTREAD, Phase 1 and Phase 2. These three program 
module? convert the ground truth data to a subpixel image format 
which has been preregistered with pixels in the LAC IE blind site 
segments. The merge of these programs will expedite the formatting 
of a Universal ground truth data file by providing a more efficient 
operating environment. 
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2. BACKGROUND 


Program modules BTREAD, Phase 1 and Phase 2, were designed and imple- 
mented to satisfy research and test requirements for LACIE Phase 3 
Accuracy Assessment processing. The initial research and test 
requirement was to convert the nine-track Bendix-100 tape to a 
nine-track Universal format image tape. This initial requirement 
was completed and acceptance tested in August 1977. Since acceptance, 
scientists and engineers from the Accuracy Assessment Team have 
provided the necessary operations expertise. With this hands-on 
operations experience as a background, the requirements to merge 
these programs so that the generation of a ground truth data file 
can be performed by Data Techniques Laboratory (DTL) operations 
personnel as developed. 


3. GENERAL REQUIREMENTS 


The following subsection defines the general requirements and various 
modifications that should be implemented in the merge of BTREAD, 

Phase 1 and Phase 2. The merge of these programs should dictate 
the use of only one input control file and require only one run 
command. 

3.1 BTREAD 

There are three special subroutines in BTREAD. These are RADER, 
FSORT, and LABEL. 

Subroutine RADER converts the NOVA floating point data recorded on 
the B-100 tape to DEC PDP 11/45 integer equivalents. FSORT arranges 
the fields in numerical order, checking for duplicate field numbers 
and tracking the number of fields. LABEL produces files of crop 
classes. 

3.1.1 BTREAD MODIFICATIONS 

The small grains and other file (Label 2 • DAT) created 1 by subroutine 
label should be deleted. This file was designed for use with module 
ALLCRP. The analysis data that was provided by module ALLCRP is 
now available in module MLTCRP. Label 3 • Dat or Label 1 • Dat 
should be selected by input control data set. 

Subroutines used in the generation of a B-tape or the need to write 
to a scratch tape should be deleted. The deletion of these sub- 
routines will eliminate the need for two digital tape units. 
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3.2 PHAS ; i- 

Phase 1 is the executive routine that calls the standard system's 
utility and special subroutines. These routines check the vertices 
in each field and construct files for use by the follow-on Phase 2 
routines. 


3.2.1 PHASE 1 INVESTIGATIONS 

Phase 1 routines have been designed to check that the digitized input 
conforms to the restrictions as specified in IDC 643-2055 (attached). 
Each restriction should be analyzed as to its merit and modified 
accordingly. 


3.2.2 PHASE 1 MODIFICATIONS 


The need for tape input (assignment of unit 4) should be deleted and 
the input statement modified to accept the output of BTREAD, as 
modified in paragraph 3.1.1 above. 


In addition, all subroutines should be modified to handle, by card 
or operator input, segments that contain any combination of 137,592 
pixels. For example, when maximum X equals 2866 samples, Y should 
equal 48 lines; when maximum Y equals 2866 lines, each line should 
’ contain 48 samples. Default should be 392 samples by 351 lines 

; (196 x 2 - 117 x 3). 

i 

3.3 PHASE 2 

; The Phase 2 subroutines use the data as formatted by BTREAD and 

Phase 1. Phase 2 organizes these data in Universal format and 
j outputs a single channel Universal Ground Truth Tape (UGTT) as an 

I output product. 

I 

< n: is 

•••UT7 


I 

! (<rvi:' ; ; 

f OF 

V 

I 


1 


3.3.1 PHASE 2 MODIFICATIONS 

Phase 2 should be modified to output two channels of data. Channel 1 
shall be the crop or land use type and channel 2 shall be the field 
number of the crop or land use type. 

In addition. Phase 2 should be modified to produce an UGTT output 
as a requester option. The default should be to the system disk 
in the users UIC. 

3.4 OUTPUT REPORTS 

Provisions must be made in the merge of BTREAD, Phase 1 and Phase 2 
to continue to provide all existing line printer reports. 


4. SYSTEMS TEST AND INTEGRATION 


The following tests shall be performed: 
e Verification of disk data and UGTT output product. 

• Verification of all line printer reports. 

• Verification of error routines and resulting error messages, 
maximum number of vertices, duplicate field numbers, field 
closure, etc. 


5. SCHEDULE 


The schedule for the merge of these routines shall include: 

• Design review 
e Coding 

e Debug 

• Integration test 

• Final acceptance 
t Documentation 
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6. DOCUMENTATION 


The following documentation is required: 

1. Flow diagrams 

2. Program listings 

3. Description of all subroutines 

4. Description of output product formats by byte 

5. Acceptance test plan 

6. Users document 
Operators procedures 


7 . 
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INTERDEPARTMENTAL COMMUNICATION 

flf.CF.lVE ' 1 PATE May i>', 19"/7 ^ 

PLAtlT/ 

I AC, LEC/SSI) 


Kofi G 43 - 20 D 0 


M. b. Rador 


jr 


DEPT,/ r.LSjG./ fl.AtlT/ 

fROM W. G. Epplor OUGM. 626-40 zont. L~V 11 I fAC, LBC/UGD 

JUI)Ji:CTi DIGITIZATION PROCEDURES AND liDNIUX TAPE FORMAT 


tXT. 333 - 

631 ). 


* • General Considc rat ions 

1. Dolininle and digitize beyo nd norain a 1 site boundari or. . 
Extra area does not cause a problem but having too 3 i title, 
area docs. 

2. Eater fields (in the sequence of digitization) take 
precedence over (i.c., ove write) earlier cj.ds, 

3, First boundaries should define. Die total ground truth 
area for a photograph. See I- l. 

4, There is no restriction on the direction in which fields 
are digitized. The boundary may even cross itself; 
c.g.i a "figure-eight'* is pemir.si.ble. 

II. pj g i t ia i ng Res tri ct i ons ' 

The programs Phase I and Phase II impose certain restrictions 
on the digitizing process; these restrictions are itemized in 
Table 1. If any of these restrictions become objectionable, 

. ‘ they can be relieved by increasing the size of buffers given 

by Table 1. 

Ill . Tape Form at. 

Each segment is assumed to have a separate 9-track COO bpi 
tune consisting of one fide. Bach field in recorded as a 
'single, f.i:e d-length (CO words) record. Word 1 gives the 
field number (1 to 499). Word 2 gives the number of vertices 
+ 2. Words 3, 5, . . ., 79 give the ^-coordinates of vertices 
2, . . ., 39. Words 4, 6, , , ., 00 give the Y-eoordinal.es 
of vertices 1, 2, . . ., 39. All of the values are to be in 
the on ' put coordinate system (i.e., hand sat Samples x 2 and 
bandsat T.Tnes x 3) , The last record (after all fields are 
recorded) is to luma the unique field number 1001. Any 
desired change, to the. assumed format can bo accomodated by 
changes to Phase I. 

cci R. L. Carroll . / , < Sj.— / /, [ /* 

P. I.. Kim mm . H/.it- (> i t. ■"/■' ,p LF •• 

P. C. Swan ay // * W. G. Epplor 

>AC 201 K. R. Vela 
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